Skip to content

remove a2a extension activation entirely in v1.0 - #2033

Open
wrenj wants to merge 2 commits into
mainfrom
rma2aext
Open

remove a2a extension activation entirely in v1.0#2033
wrenj wants to merge 2 commits into
mainfrom
rma2aext

Conversation

@wrenj

@wrenj wrenj commented Jul 17, 2026

Copy link
Copy Markdown
Collaborator

We made extension activation optional previously as nobody was using it and we didn't need it.
For 1.0 we explicitly remove it.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request removes the A2A extension activation mechanism entirely from the specification, transitioning clients and agents to rely solely on A2A metadata for negotiating supported A2UI versions and catalogs. The review feedback points out that the Python SDK implementation still contains the legacy activation logic and needs to be updated to align with this change. Additionally, several grammatical and phrasing improvements are suggested for the documentation to enhance clarity and correctness.

Comment thread specification/v1_0/docs/evolution_guide.md

### 2.6. Agent card and transport metadata

- Removed the A2A extension activation mechanism entirely. Clients and agents now rely purely on A2A metadata to negotiate supported A2UI version and catalogs.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Grammar/phrasing suggestion: "negotiate supported A2UI version and catalogs" should be "negotiate the supported A2UI version and catalogs" or "negotiate supported A2UI versions and catalogs" for proper parallel structure and article usage.

Comment thread specification/v1_0/extensions/a2a/docs/a2ui_extension_specification.md Outdated
Comment thread specification/v1_0/extensions/a2a/docs/a2ui_extension_specification.md Outdated
@wrenj
wrenj enabled auto-merge (squash) July 27, 2026 17:23
}
}
```
A2UI does not use A2A extension activation. Clients advertise the supported A2UI version and catalogs by attaching `message.metadata['a2uiClientCapabilities']` to their messages. Agents use A2UI by sending payloads with `DataPart.data.metadata['mimeType'] = 'application/a2ui+json'` to clients.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: Maybe we can explicitly mention that the developer simply sets the version-specific client capabilities submessages to indicate which protocol versions are available. E.g.

{
   "v0.9" : { "supportedCatalogIds": [ ... ]}
}

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants